home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 32 / Mac Magazin and MacEasy Magazine CD - Issue 32.iso / Grafik & Text / OzTeX3.0 / Help-files / Changes to OzTeX 1.9 < prev    next >
Text File  |  1996-09-12  |  19KB  |  386 lines
  1. Changes to OzTeX 1.9
  2. ====================
  3.  
  4. OzMF
  5. ----
  6.  
  7. • OzMF is a new implementation of Donald Knuth's Metafont program.
  8.   Metafont's main function is the creation of fonts suitable for use
  9.   with TeX.  Metafont creates GF (Generic Font) files, so OzMF includes
  10.   a tool called GFtoPK for converting GF files to the PK (PacKed) format
  11.   used by OzTeX.  OzTeX can call on OzMF to make missing PK files on demand.
  12.  
  13. • The OzMF application should be kept in the same folder as OzTeX, along
  14.   with the Metafont folder which contains these sub-folders:
  15.  
  16.   Configs -- Contains the configuration files used by OzMF.
  17.   Like OzTeX, OzMF can be customized by selecting config files from a
  18.   Config menu.  OzMF reads the Default config file when it starts up.
  19.  
  20.   Inputs  -- Contains a large library of Metafont input files.
  21.  
  22.   Bases   -- Contains mf.pool (read by INIMF) and various .base files.
  23.   Base files are the Metafont equivalent of TeX's format files.
  24.   INIMF is used to build base files.  Two base files are distributed:
  25.   Plain.base and MakeTeXPK.base.  The latter is used by MakeTeXPK and
  26.   contains common mode_defs for Mac printers, plus some settings suitable
  27.   for Mac screens; see MakeTeXPK.mf in the Inputs sub-folder.
  28.  
  29.   Help    -- Contains the files used in the OzMF Help menu.
  30.  
  31. • OzTools has gone.  OzMF includes all the tools that were in OzTools, plus
  32.   a few new ones: MakeTeXPK, GFtoPK, GFtoDVI, GFtype, PKtype and AFM2TFM.
  33.  
  34. • Some of the programs that were in OzTools have changed slightly:
  35.  
  36.   VFtoVP looks for a TFM file in the current folder first, then in the list
  37.   of folders given by the tfm_folders parameter.
  38.  
  39.   VPtoVF now creates a TFM file in the same folder as the VF file
  40.   (ie. the same folder as the input VPL file).  TFM files and VF files
  41.   have a different file type, so you can use the Finder's "View by kind"
  42.   item if you need to select a bunch of TFM files.
  43.  
  44.   TFtoPL/PLtoTF/VFtoVP/VPtoVF have been rebuilt with larger arrays to cope
  45.   with some big TFMs in the new PSNFSS package.  Also fixed a bug in TFtoPL
  46.   and VFtoVP.
  47.  
  48. OzDVIPS
  49. -------
  50.  
  51. • OzDVIPS is a new implementation of Tom Rokicki's dvips program, the most
  52.   widely used DVI-to-PostScript translator.  OzTeX can call on OzDVIPS to
  53.   convert a DVI file to PostScript, then print and delete the .ps file.
  54.   People who have access to a PostScript printer and require support for
  55.   advanced graphics, like colour and rotation, should use OzDVIPS rather
  56.   than OzTeX's built-in translator.
  57.  
  58. • The OzDVIPS application should be kept in the same folder as OzTeX, along
  59.   with the DVIPS folder which contains these sub-folders:
  60.  
  61.   Configs -- Contains the configuration files used by OzDVIPS.
  62.   OzDVIPS reads the Default config file when it starts up.
  63.  
  64.   Inputs  -- Contains various input files required by dvips.
  65.   The most important files are config.ps, psfonts.map and the *.pro files.
  66.  
  67.   Docs    -- Contains the dvips documentation and some test files.
  68.   To print off a copy of the dvips manual, run dvips.tex through TeX and
  69.   then print out dvips.dvi using OzDVIPS (do NOT use OzTeX's translator
  70.   because dvips.dvi contains \special commands that OzTeX cannot process).
  71.  
  72.   Help    -- Contains the files used in the OzDVIPS Help menu.
  73.  
  74. • For compatibility with OzTeX, OzDVIPS includes a number of enhancements
  75.   and changes to the standard dvips program:
  76.  
  77.   OzDVIPS can process \special commands that include PICT or MacPaint files,
  78.   just like OzTeX's DVI-to-PS translator.  This means that OzDVIPS can be
  79.   used to print the OzTeX User Guide.
  80.  
  81.   Like OzTeX, OzDVIPS can download PostScript font files (of type LWFN).
  82.   This is very handy if you want to use the BaKoMa or CM/PS fonts.  If so,
  83.   you will need to append psfonts.BaKoMa (or psfonts.CMPS) to psfonts.map.
  84.   You must also tell OzDVIPS where to find the font files by adding their
  85.   folder location to the header_folders list in the Default config file.
  86.   PostScript font files are normally kept in the System's Fonts folder, so
  87.   the path should look something like "MyDisk:System:Fonts:".  Note that
  88.   full path names do NOT start with a colon.
  89.  
  90.   I've also added a number of config.* files to DVIPS:Inputs so that you can
  91.   pass an extra option like "-P CMPS" to tell dvips to load config.CMPS after
  92.   config.ps; config.CMPS contains the line "p +psfonts.CMPS" which tells
  93.   dvips to append the font info in psfonts.CMPS to the info in psfonts.map.
  94.   This is useful if you don't want to make changes to psfonts.map.
  95.  
  96.   The TFM names in psfonts.* files are case insensitive (like Mac file names).
  97.  
  98.   In most operating systems, dvips uses environment variables to override
  99.   the settings in config.* files loaded at the start of every run.  Most of
  100.   the variables define search paths for locating files of various types.
  101.   OzDVIPS replaces these environment variables with parameters in its own
  102.   configuration files (not to be confused with config.* files), but in this
  103.   case the config.* files override the current configuration parameters.
  104.   (The supplied config.ps file does NOT override any parameters and it is
  105.   not something I would recommend doing.  For more information, see the
  106.   comments at the end of the Default file in DVIPS:Configs.)
  107.  
  108. • Like OzTeX, OzDVIPS can call on MakeTeXPK in OzMF to make missing PK files
  109.   on demand.
  110.  
  111. • OzDVIPS can run by itself, or can be called from OzTeX (tick "Use DVIPS").
  112.   The latter method is probably the simplest for most people, but it does
  113.   require System 7 or later, and you will need about 3Mb of memory to run
  114.   both OzTeX and OzDVIPS (plus another 1.5Mb if OzMF is required).
  115.   
  116.   If OzDVIPS is run by itself then, after selecting a DVI file, a dialog box
  117.   will appear and let you select various options.  This dialog box does NOT
  118.   appear when OzTeX calls OzDVIPS because all the required options are passed
  119.   along with the DVI file.
  120.  
  121. • OzDVIPS can send a PostScript file to the current (PostScript) printer.
  122.   At the end of a successful dvips run, OzDVIPS can be told (via the send_ps
  123.   and delete_ps parameters) to print the PostScript file, and then delete it.
  124.  
  125. TeX changes
  126. -----------
  127.  
  128. • TeX now recognizes either return or linefeed (ASCII code 10) as the end of
  129.   line character in an input file.  This means that TeX can read Unix text
  130.   files unmodified and should eliminate most buf_size overflow problems.
  131.   Ditto for OzMF and text files read by Metafont, PLtoTF, VPtoVF and AFM2TFM.
  132.  
  133. • OzTeX now looks in a TeX file for "%&format" on the first line and,
  134.   if present, uses the given format regardless of the currently ticked
  135.   format in the TeX menu, or the format in the log file.  This is a much
  136.   safer way to specify a particular format and I might eventually remove
  137.   the "Use Format in Log" flag and its corresponding code.
  138.   Similarly, OzMF looks for "%&base" on the first line of a Metafont file.
  139.  
  140. LaTeX changes
  141. -------------
  142.  
  143. • The latest release of LaTeX has been installed.  The LaTeX, Graphics,
  144.   PSNFSS and Tools folders inside TeX-inputs have all been updated.
  145.   A new LaTeX.fmt file is in the TeX-formats folder.
  146.  
  147. • The new 8r fonts in the PSNFSS package meant quite a few changes:
  148.   - New TFM files in the TeX-fonts:PS folder.
  149.   - New VF files in the VF-files folder.
  150.   - PostScript font entries in OzTeX's Default config now use 8r names.
  151.   - Similar changes to psfonts.map in the DVIPS:Inputs folder.
  152.   - Also added 8r.enc file to DVIPS:Inputs.
  153.   - Increased font_mem_size by 8000 in Default config to handle bigger TFMs.
  154.   - Made two changes to OzTeXdict.pro and DVItoPS.pro in the PS-files folder:
  155.     1. Added support for "UN-" prefix (unslanted italic).
  156.     2. Changed condense value from 0.8 to 0.82 to match the new TFMs.
  157.   - Updated psnames.tex in the TeX-inputs:Plain folder.
  158.   - Updated psfonts.tex and fontsample.tex in the TeX-docs folder.
  159.  
  160. DVIDVI
  161. ------
  162.  
  163. • The new DVIDVI item in OzTeX's TeX menu can be used to carry out
  164.   pagination tricks on a given DVI file.  (OzTeX implements DVIDVI 1.0,
  165.   originally written by Tom Rokicki, with modifications by Esteban Zimanyi.)
  166.   For more information, select the new DVIDVI item in OzTeX's Help menu.  
  167.  
  168. Configuration file changes
  169. --------------------------
  170.  
  171. • All config files distributed with OzTeX use a new keyword-based syntax.
  172.   I finally realized that the old position-based syntax was a dumb idea.
  173.   The new syntax makes it much easier for me to add new parameters,
  174.   plus it reduces the size and complexity of non-default config files.
  175.  
  176.   Config files using the old syntax can be read by OzTeX 2.0, but this
  177.   ability will probably disappear in a later version, so if you have your
  178.   own set of config files then I strongly recommend that you convert them
  179.   over to the new syntax as soon as possible.  It's quite easy:
  180.  
  181.   1. Start up OzTeX 2.0 and load an old config file.
  182.   2. Select Show All from the Config menu.
  183.   3. Use the mouse to select lines containing the appropriate parameters,
  184.      then select Copy from the Edit menu.
  185.   4. Open the config file in a text editor and Paste in the parameters
  186.      using the new syntax.  Delete all old lines ending with "= ?".
  187.   5. Save your changes and make sure OzTeX can load the new config file
  188.      without getting any errors.
  189.  
  190.   If you have problems, send in your old config file by e-mail and I'll
  191.   convert it for you (this offer is only to registered users!).
  192.  
  193. • OzTeX has some new configuration parameters:
  194.  
  195.   printing_mode = <mode-name>
  196.   viewing_mode  = <mode-name>
  197.   Use these parameters to specify the printing and viewing modes that
  198.   will be passed by OzTeX to OzMF when making missing PK fonts.
  199.   (The old config file syntax required these modes to be given on the same
  200.   lines as the resolution values --- a hack to avoid adding new parameters!)
  201.  
  202.   printing_config = <config-name>
  203.   viewing_config  = <config-name>
  204.   If the given printing_config is non-empty then OzTeX will automatically
  205.   load the named config file just before printing a DVI or text file.
  206.   Similarly, if the given viewing_config is non-empty then OzTeX will
  207.   automatically load the config file just before previewing a DVI file.
  208.   The Default config sets both these parameters empty, so nothing different
  209.   will happen.  However, people who want to use a different set of fonts
  210.   (not just different resolutions) for viewing and printing could set up
  211.   appropriate config files.  For example, the "View CM using PS" config now
  212.   sets the printing_config to "Default" so that after previewing a DVI file
  213.   using "View CM using PS" you don't have to remember to load the Default
  214.   config before printing.
  215.  
  216.   standard_prolog = <file-name>
  217.   This parameter specifies the prolog file used by OzTeX if printing a DVI
  218.   file to a PostScript device when "Use Standard PostScript" is ticked.
  219.   The Default config sets standard_prolog to :PS-files:OzTeXdict.pro.
  220.  
  221.   dvidvi_output   = <file-name>
  222.   dvidvi_examples = <file-name>
  223.   These two parameters are used by DVIDVI.  The first specifies the default
  224.   name of the new output file created by DVIDVI.  The second specifies the
  225.   name of a file that is displayed just before you enter the DVIDVI options.
  226.   The file specified in the Default config reminds you of the possible
  227.   options; note that you can copy and paste the displayed examples.
  228.  
  229.   input_file_suffixes = <list>
  230.   This parameter allows you to specify a list of suffixes for the files
  231.   seen in the "TeX..." file dialog.  The Default config sets the list to
  232.   ".tex .ltx .dtx .ins" which matches the most common suffixes for TeX and
  233.   LaTeX input files.  Note that an empty list would show all (TEXT) files.
  234.   The given list is also used by OzTeX to determine whether a text file
  235.   should be typeset if it is dropped onto OzTeX or opened via an Apple
  236.   "open document" event.
  237.  
  238.   dvips_application = <file-name>
  239.   OzTeX calls the given application if "Use DVIPS" is ticked when printing
  240.   a DVI file.  The Default application is OzDVIPS.
  241.  
  242.   mf_application = <file-name>
  243.   OzTeX calls the given application to make a missing PK font when printing
  244.   or previewing a DVI file.  The Default application is OzMF.
  245.  
  246. • A new config file for 600 dpi printers has been included.  Note that the
  247.   printing_mode is set to "ljfour"; this will create PK fonts suitable for
  248.   a HP LaserJet 4.  If you have a different type of 600 dpi printer then
  249.   you might need to use a different mode to get better looking fonts.
  250.  
  251. • The missing_fonts_file parameter in the Default config is now called
  252.   missfont.make rather than missfont.log.  This was done because OzMF's
  253.   MakeTeXPK command looks for file names ending in ".make".  Note that
  254.   you won't be able to use an old missfont.log file with OzMF's MakeTeXPK
  255.   because the format has changed: an explicit font magnification must be
  256.   included as the 2nd last parameter in every line.  If you attempt to give
  257.   an old file to MakeTeXPK then you'll get an "unexpected end of line" error.
  258.  
  259. • Added support for reencoding PostScript fonts.  This was required now
  260.   that the latest PSNFSS package in LaTeX uses fonts with the 8r encoding.
  261.   [Much thanks to Olof Karis, Hans van der Meer and Helmut Frosch for their
  262.   help in creating the support files.]
  263.  
  264.   There are new versions of DVItoPS.pro and OzTeXdict.pro in the PS-files
  265.   folder.  The changes to both .pro files are identical and consist of a
  266.   new version of the "newPSfont" procedure and four new encoding vectors:
  267.   7tEnc, 8rEnc, T1Enc and L1Enc.  To support these new encoding vectors,
  268.   four encoding files have been added to the Encodings sub-folder in
  269.   PS-files: Mac7t.enc, Mac8r.enc, MacT1.enc and MacL1.enc.
  270.  
  271.   To use reencoded fonts, your config file(s) must have suitable PostScript
  272.   font entries.  For example, the new Default config file includes entries
  273.   like this:
  274.  
  275.     ptmr8r    8r-Times-Roman      Times   Mac8r.enc
  276.     ptmb8r    8r-Times-Bold       Times   Mac8r.enc   b
  277.     ptmro8r   8r-SL-Times-Roman   Times   Mac8r.enc   i
  278.  
  279.   The prefix "8r-" tells OzTeX to do font reencoding using the 8rEnc
  280.   encoding vector.  The prefixes currently supported are:
  281.  
  282.     7t-   reencode using 7tEnc (OT1)
  283.     8r-   reencode using 8rEnc (raw)
  284.     T1-   reencode using T1Enc (T1 or Cork)
  285.     L1-   reencode using L1Enc (ISO Latin 1)
  286.     CO-   condense by 0.82
  287.     EX-   expand by 1.2
  288.     SL-   slant by 0.167 (the old "Slanted-" prefix also works)
  289.     UN-   unslant (slant by -0.1763)
  290.  
  291.   Prefixes can be mixed; see "8r-SL-Times-Roman" in the above example.
  292.   The ordering doesn't matter, so "SL-8r-Times-Roman" would also work, but
  293.   it is a good idea to be consistent and keep the reencoding prefix first.
  294.  
  295.   The above scheme is simply an extension of the old method used by OzTeX
  296.   to create slanted fonts.  The new scheme is more versatile and I've tried
  297.   to make the newPSfont code very simple so that people can make changes
  298.   (like adding other prefixes) without knowing much about PostScript.
  299.   The four encoding vectors in the .pro files might take up too much printer
  300.   memory for some people's liking.  If so, simply chop out the encoding
  301.   vectors that aren't required.  As distributed, OzTeX only uses 8rEnc.
  302.  
  303. Miscellaneous changes
  304. ---------------------
  305.  
  306. • OzTeX, OzMF and OzDVIPS are "fat" applications containing both 68000 and
  307.   PowerPC code.  If all that extra fat worries you then use a utility like
  308.   StripFat to remove the unwanted code.  I no longer distribute 68020-compiled
  309.   applications because the speed improvement (typically < 5%) is not large
  310.   enough to warrant all the hassle. [Thanks to Andy Fyfe for his timing data.]
  311.  
  312. • Text in the OzTeX/OzMF/OzDVIPS windows can be selected and copied to the
  313.   Clipboard via the Copy item in the Edit menu.  Command-C is no longer
  314.   equivalent to Command-period.  The cursor changes to an I-beam if moved
  315.   over the contents region.
  316.  
  317. • The "Save OzTeX Window" and "Copy OzTeX Window" items have been renamed to
  318.   "Save All Text" and "Copy All Text".
  319.  
  320. • The File menu has a new Delete item that lets you delete files ending in
  321.   a given string selected from a sub-menu (eg. ".log").  The file dialog has
  322.   a "Do all files" button that lets you delete all such files in the selected
  323.   folder.  Use it with caution!  (A note to ResEdit hackers: you can modify
  324.   the Delete MENU resource to create your own list of suffixes.)
  325.  
  326. • The warning and fatal dialog boxes now appear in the middle of the main
  327.   screen and contain the icons recommended by the Apple thought police.
  328.   The warning dialog also has a new Cancel button; this makes it easy to do
  329.   things like cancel a whole heap of \special errors when viewing a DVI file
  330.   (try page 16 in nasty.dvi for example).
  331.  
  332. • The new AMS folder contains the latest versions of AMS-TeX, AMS-LaTeX and
  333.   the AMS fonts.  AMSTeX.fmt has also been added to the TeX-formats folder.
  334.   [Much thanks to John Rawnsley and Bruno Voisin for their help creating
  335.   the AMS folder.]
  336.  
  337. • Some TeX parameters in OzTeX's Default config file have been increased so
  338.   that users can process the docs in the AMS folder.  This required rebuilding
  339.   all format files and increasing OzTeX's preferred memory size to 1700K.
  340.  
  341. • Updated psfonts.BaKoMa and "Add BaKoMa Fonts" to include the AMS fonts
  342.   (thanks to Stephan Heilmayr for creating the necessary screen fonts).
  343.   Also added BaKoMaAMS.enc file to :PS-files:Encodings: (thanks to Tom Scavo).
  344.  
  345. • Fixed a bug in "Fix VFs in DVI" that was causing \special info to
  346.   end up garbled if it came from a VF file.
  347.  
  348. • Added code to support \special{Warning: ...} messages.  Such \specials are
  349.   used in the new VF files to indicate missing glyphs.
  350.  
  351. • Fixed a bug in the handling of EPSF \special files.  The bug only occurred
  352.   if the PICT frame did not match the BoundingBox values.
  353.  
  354. • OzTeX's handling of bad DVI files has been improved.  It should no longer
  355.   crash, nor will you be forced to quit OzTeX.
  356.  
  357. • BBEdit Lite is no longer distributed with OzTeX.  In its place is the
  358.   AlphaLite editor by Pete Keleher; this is a smaller version of Alpha but
  359.   still retains many handy features for editing TeX/LaTeX input files.
  360.   AlphaLite is shareware (US$15), so please use Pete's Register program
  361.   to pay the registration fee if you decide to keep AlphaLite.
  362.  
  363. • Some new TeX-related programs are now distributed with OzTeX:
  364.  
  365.   BibTeX, by Vince Darley, is used in conjunction with LaTeX to generate
  366.   a bibliography from information stored in a bibliographic database.
  367.   The original version of BibTeX was written by Oren Patashnik.
  368.  
  369.   MakeIndex, by Rick Zaccone, can be used to create a sorted index for
  370.   TeX/LaTeX documents.  The original version was written by Pehong Chen.
  371.  
  372.   Excalibur is a spelling checker by Rick Zaccone and Robert Gottshall.
  373.   Although designed to handle LaTeX documents, it also does a fairly good
  374.   job with plain TeX files.
  375.  
  376.   Please note that I am NOT an expert on any of these programs, so contact
  377.   the various authors if you have any questions.
  378.  
  379. • The following sections in the OzTeX User Guide have been added or updated:
  380.   - Configuration files
  381.   - PostScript fonts (new subsection on reencoding)
  382.   - OzMF
  383.   - OzDVIPS
  384.  
  385. Phew.
  386.